home *** CD-ROM | disk | FTP | other *** search
/ Shareware Super Platinum 8 / Shareware Super Platinum 8.iso / mac / DIAGTOOL / INTVU14A.ZIP;1 / INTERVUE.DOC next >
Encoding:
Text File  |  1993-01-25  |  5.7 KB  |  111 lines
  1.  
  2.                                INTERVUE V1.4a
  3.                                January, 1993
  4.                       Copyright Hackensack, 1992, 1993
  5.                               
  6.  
  7.   INTERVUE is a viewer for the Interrupt List maintained by Ralf Brown.  
  8.   The program is Public Domain Software and may be freely copied and 
  9.   distributed.  The Interrupt List is avaliable for downloading from
  10.   CompuServe and numerous other BBS's.  The files are named INTnnA.ZIP,
  11.   INTnnB.ZIP, and INTnnC.ZIP (nn = current release no.).  
  12.   
  13.   INTERVUE is provided as a 'no frills' alternative to the commercial 
  14.   Interrupt List viewers.  The primary design critera were compatibity with 
  15.   the widest range of operating environments and small executable size.  No 
  16.   modification to the Interrupt List files is required for using the viewer.
  17.  
  18.   Version 1.4a contains an improved search alogrithm for the List entries,
  19.   case insensitive search, expanded technical documentation, and includes
  20.   a Windows Icon.
  21.  
  22.   INTERVUE is designed to be backward and foward compatible with the 
  23.   Interrupt List releases, subject to the following constraints: 
  24.  
  25.         The Summary File format must be compatible with release 32.
  26.         The individual List files size must not exceed 6 segments (393Kb).
  27.         The number of List files must not exceed 12.
  28.         The INTERRUP.A file header format must be consistent with release 32.
  29.         
  30.   To install INTERVUE, first copy the Interrupt List files, INTnnA.ZIP and 
  31.   INTnnB.ZIP, to a subdirectory on the fixed disk and UNZIP them.  Next, use 
  32.   INTPRINT to create the Summary File (INTERRUP.SUM) with the following 
  33.   command:
  34.  
  35.         INTPRINT -sINTERRUP.SUM -m -i INTERRUP.A nul
  36.  
  37.   Copy INTERVUE to the Interrupt List directory and execute the program.  
  38.   The INTERRUP.SUM file serves as the menu for accessing the function 
  39.   descriptions contained in the Interrupt List files (INTERRUP.?).  To run 
  40.   INTERVUE from a search path, add the following command to the AUTOEXEC.BAT 
  41.   file:
  42.  
  43.         set intervue = drv:\path
  44.  
  45.   The 'drv:\path' is the drive and path where the Interrupt List files are
  46.   located.  INTERVUE may then be placed in any active search path.
  47.  
  48.   The following keys are active within the INTERVUE text display window:
  49.   Home, End, PageUp, PageDn, UpArrow, DnArrow, Tab, Shift-Tab, Esc, F1, 
  50.   F2, F3, Ctrl-C, & Enter.
  51.  
  52.   INTERVUE is written in 8086 assembler, uses conventional memory (640Kb)
  53.   only, compatible with DOS 2.0 & >, RSIS compliant (DESQview aware), and 
  54.   is compatible with both mono and color video.  Requires 3Mb disk space
  55.   for the Interrupt List files (unzipped).  INTERVUE has no command line
  56.   parameters, does not use a setup file, and makes no disk writes.
  57.  
  58.                           Search Alogrithm:
  59.  
  60.   At initialization, the environment is checked for a path to the Interrupt
  61.   List files.  If none is found, the default path is used.  INTERRUP.A is 
  62.   opened and the first 1680 bytes of text are read to build an array mapping 
  63.   Int, Fct, & Sub to the INTERRUP file extension.  Next, INTERRUP.SUM is read 
  64.   into the file buffer and displayed as a menu.  When a function is selected 
  65.   (Enter), the List file with the Int, Fct, & Sub is read into the buffer and 
  66.   searched for a match.
  67.  
  68.   The search string is formed from the Summary file entry by re-creating
  69.   the List file description line (three format variations).  The List
  70.   file description line does not contain the Fct & Sub, so a verify string 
  71.   is created to check the List file dashed line above the description for 
  72.   Int, Fct & Sub.  A hit is returned from verify if either a match is 
  73.   found, or if Int, Fct & Sub are absent from the dashed line above the 
  74.   description (some with Int only are missing).  The verify compare allows 
  75.   List file formatting fluctuations of + or - 5 bytes.  
  76.  
  77.   The only observed search problem occurs from identical entries (Int, Fct,
  78.   Sub, & description) in the Summary file.  The search will always find the 
  79.   first of these entries in the List file.  Use of F3 (next match) will 
  80.   reveal all of the subsequent identical description entries in the List file, 
  81.   which will show unique values in BX or other registers.  With the 'feature' 
  82.   documented, and with awareness of how the search works, this should be a
  83.   minor inconvience. 
  84.    
  85.   The List file is always searched sequentially from the beginning in order 
  86.   to count the newlines and display the tally.  No pointers are used with  
  87.   the List files, and no binary search techniques are used.  The file buffer
  88.   segment offset is incremented by one following each byte compare, and
  89.   tested for zero to identify segment boundaries.  The aux timer vector is
  90.   unhooked/hooked and start/end crit section (2F 16 81-82 & 15 DE 1C-1B) is 
  91.   called for file reads and the search.  A time slice is released for DPMI
  92.   (Windows) and DESQview in idle loops.  The file reads are 8000h, with a 
  93.   compare of AX, CX for eof.  
  94.  
  95.   Memory is released, retaining 16Kb for the program, and 6 segs allocated  
  96.   for the file buffer.  Errors trapped are mem allocation, file too big, file 
  97.   not found, checksum, and crit.  Stack seg is 512 bytes.
  98.   
  99.  
  100.   The INTERVUE program is provided by Hackensack, the publisher of INTRCPT, 
  101.   a Windows\Dos Interrupt trapper and real-time debugger.  For information 
  102.   on INTRCPT and discounts avaliable to Interrupt List users, contact 
  103.   Hackensack, PO Box 181386, Arlington, TX  76096 or CompuServe 76570,2752.
  104.  
  105.   Please report any INTERVUE bugs or problems, and upgrade suggestions.
  106.  
  107.                                       Thanks,
  108.                                       Bob Williamson
  109.                                       CIS 76570,2752
  110.                 
  111.